LGF_FileDelete (FB / 1.0.0)

Übersicht

Autor: Simatic Systems Support

Kurzbeschreibung

Dieser Funktionsbaustein löscht eine Datei, die auf der Speicherkarte der SPS (SMC) im Ordner UserFiles gespeichert ist.

Baustein Schnittstelle

LGF_FileDelete (FB)
Bool  execute done  Bool
    
String  fileName busy  Bool
    
   error  Bool
    
   fileDoesNotExist  Bool
    
   status  Word
    
   diagnostics  LGF_typeDiagnostics
    
   

Input Parameter

BezeichnerDatentyp Default Wert Beschreibung
executeBool FALSE Steigende Flanke startet Löschen der Datei
fileNameString '' Name der Datei inklusiv Pfad: `UserFiles/test.dat`

Output Parameter

BezeichnerDatentyp Beschreibung
doneBool TRUE: FB-Abarbeitung erfolgreich fertiggestellt
busyBool TRUE: FB ist aktiv; neue Ausgabewerte können erwartet werden.
errorBool TRUE: Bei der Ausführung der Funktionalität ist ein Fehler aufgetreten
fileDoesNotExistBool True: Die Datei oder der Pfad unter `Dateiname` existiert nicht
statusWord 16#0000-16#7FFF: Status des FB / 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
diagnosticsLGF_typeDiagnostics Diagnosestruktur zur Speicherung und Übertragung von Diagnoseinformationen von Blöcken über die Schnittstelle.

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_EXECUTION_FINISHED
Ausführung ohne Fehler beendet
16#7000STATUS_NO_CALL
Kein Job wird gerade verarbeitet
16#7001STATUS_FIRST_CALL
Erster Aufruf nach Eingang eines neuen Auftrags (steigende Flanke 'execute')
16#7002STATUS_SUBSEQUENT_CALL
Nachfolgender Aufruf bei aktiver Verarbeitung ohne weitere Angaben
16#8401ERR_FILE_PATH
Fehler: Dateipfad Fehler: der Dateipfad muss mit 'UserFiles/' beginnen.
16#8600ERR_UNDEFINED_STATE
Fehler aufgrund eines undefinierten Zustands im Zustandsautomaten
16#8604ERR_FILE_DELETE_INIT
Fehler: Datei von der SMC lesen - siehe `diagnostics.subFunctionStatus`
16#8605ERR_FILE_DELETE
Fehler: Datei von SMC lesen - siehe `diagnostics.subFunctionStatus`

Benutzer definierte Datentypen

LGF_typeDiagnostics (UDT / V1.0.1)

Diagnosestruktur zur Speicherung und Übertragung von Diagnoseinformationen von Blöcken über die Schnittstelle.

Bezeichner Datentyp Default Wert Beschreibung
status Word 16#0000 Status des Bausteins oder Fehleridentifikation beim Auftreten des Fehlers
subfunctionStatus Word 16#0000 Status oder Rückgabewert von aufgerufenen FB's, FC's und Systembausteinen
stateNumber DInt 0 Zustand in der Zustandsmaschine des Blocks, in dem der Fehler aufgetreten ist

Funktionsbeschreibung

Mit der Funktion LGF_FileDelete kann eine Datei von der SIMATIC Memory Card (SMC) gelöscht werden.

Der Dateiname muss immer vollumfänglich zusammen mit dem Ordner Namen und der Datei Erweiterung in folgendem Format angegeben werden: UserFiles/test.dat

Änderungshistorie

Version & DatumÄnderungsbeschreibung
1.0.0Simatic Systems Support
29.04.2025First released version